home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 014 / qf23d.arc / QFILER.DOC < prev    next >
Text File  |  1986-11-08  |  41KB  |  819 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                         ******************************
  11.                         *                            *
  12.                         *                            *
  13.                         *           QFILER           *
  14.                         *                            *
  15.                         *                            *
  16.                         *        USERS'MANUAL        *
  17.                         *                            *
  18.                         *                            *
  19.                         ******************************
  20.  
  21.  
  22.  
  23.                           A File Maintenance Utility
  24.                              written by Kenn Flee
  25.                                       of
  26.                               Jamestown Software
  27.                            2508 Valley Forge Drive
  28.                               Madison WI  53719
  29.                    Copyright (C)1986 by Jamestown Software
  30.  
  31.  
  32.                                  Version 2.3
  33.                               November 8, 1986
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.          Jamestown  Software  will  not  be  liable  for  any damages,
  42.          including any lost profits, lost savings or other  incidental
  43.          or consequential  damages   arising  out  of  the  use  of or
  44.          inability to use QFILER.COM,  even if Jamestown Software  has
  45.          been advised of the possibility  of such damages, or for  any
  46.          claim by any other party.
  47.  
  48.  
  49.          QFILER USERS' MANUAL                                  Page  1
  50.  
  51.  
  52.                            QFILER TABLE OF CONTENTS
  53.  
  54.          Quick Start  . . . . . . . . . . . . . . . . . . . . Page 2
  55.          User interface . . . . . . . . . . . . . . . . . . . Page 2
  56.          System requirements  . . . . . . . . . . . . . . . . Page 3
  57.          Setting up for Qfiler  . . . . . . . . . . . . . . . Page 3
  58.          Screen sample illustration . . . . . . . . . . . . . Page 4
  59.          Geography and Navigation . . . . . . . . . . . . . . Page 5
  60.          Function Key assignments . . . . . . . . . . . . . . Page 6
  61.          Menu selections  . . . . . . . . . . . . . . . . . . Page 7
  62.          Control/Alternate-key combinations . . . . . . . . . Page 9
  63.          Error messages . . . . . . . . . . . . . . . . . . . Page 12
  64.          User-support . . . . . . . . . . . . . . . . . . . . Page 13
  65.          Sample Invoice . . . . . . . . . . . . . . . . . . . Page 14
  66.  
  67.  
  68.                                  QFILER FILES
  69.  
  70.          The following  program  and  documentation  files  should  be
  71.          included in the distribution copy of QFILER.
  72.  
  73.                     QFILER.COM   -  Executable program.
  74.                     QFILER.DOC   -  This documentation.
  75.                     QFKEYS.TXT   -  Printable Function Key template.
  76.                     QFUPDATE.DOC -  QFILER update/revision history.
  77.  
  78.          The following  are Jamestown  Software products  which may be
  79.          used as standalone products or as integrated parts of QFILER.
  80.  
  81.                     FCDISK.COM   -  Disk-Directory file builder.
  82.                     FCDISK.DOC   -  Documentation for above.
  83.                     FILECAT.COM  -  Disk cataloging database.
  84.                     FILECAT.DOC  -  Filecat documentation file.
  85.                     FILECAT.KWD  -  Library of keywords. .
  86.                     FINC01.CHN   -  Required FILECAT program file.
  87.                     FINC02.CHN   -  Required FILECAT program file.
  88.                     LITLBOOK.COM -  LITLBOOK Address book database.
  89.                     LITLBOOK.DOC -  LITLBOOK documentation file.
  90.  
  91.          Additionally, the following excellent user-supported programs
  92.          by Vernon D. Buerg, (456 Lakeshire, Daly City, CA 94015), and
  93.          by Larry McMains,  may also be  included.  If available  in a
  94.          pathed directory, they  can be linked  to by QFILER,  and are
  95.          also great standalone  products.  If a  distribution diskette
  96.          was not ordered from Jamestown Software, check a local BBS as
  97.          a source for these files.  They will often be listed with  an
  98.          imbedded version number, such as LIST60J.ARC.  They will also
  99.          include necessary documentation.
  100.  
  101.            LIST.ARC     -  Vernon D. Buerg -  File browse utility.
  102.            ARCA.ARC     -  Vernon D. Buerg -  ARChive Add utility.
  103.            ARCV.ARC     -  Vernon D. Buerg -  ARChive listing utility.
  104.            ARCE.ARC     -  Vernon D. Buerg -  ARChive Extract utility.
  105.            FINDIT.ARC   -  Larry McMains   -  File search utility.
  106.  
  107.          QFILER USERS' MANUAL                                  Page  2
  108.  
  109.  
  110.                                  QUICK-START
  111.  
  112.          If it is necessary to use QFILER immediately, please read  at
  113.          least this section first to become acquainted with the  basic
  114.          options.  Please read the rest of the documentation at  first
  115.          opportunity.   QFILER  may  be  invoked  by typing QFILER and
  116.          pressing [Enter] at the DOS prompt.  Command-line options may
  117.          be  included  after  typing  QFILER.   An "M" included on the
  118.          command line will force QFILER to run in black and white mode
  119.          if a monochrome  monitor is hooked  to a color  display video
  120.          board.
  121.  
  122.          Once in QFILER, pressing "H" will display a help screen  with
  123.          a quick summary of function and cursor keys assignments.
  124.  
  125.          Files  are  displayed  in  two  windows.   When  selecting  a
  126.          drive\directory (<F5>  and <F6>)  to be  shown in  one of the
  127.          windows, the following will be true:
  128.  
  129.              C or \ -- by itself will change to the root directory  of
  130.                        the drive\directory (C:\ in this case).
  131.  
  132.              C: --     with  a  colon  will  change  to  the   current
  133.                        directory  of the indicated drive\directory; if
  134.                        no current  directory, then the root directory.
  135.  
  136.              C:\DOS -- any defined paths of 3 or more characters  will
  137.                        force  QFILER  to  attempt  to  change  to  the
  138.                        identified drive\directory.
  139.  
  140.          Pressing Control-P  will bring  up a  menu to  set or  cancel
  141.          skip-over-perf on Epson and Epson-compatible printers.
  142.  
  143.  
  144.                                 USER INTERFACE
  145.  
  146.          QFILER outwardly resembles FFM (A popular user-supported file
  147.          management  program   by  Neidert   Software)  in   its  user
  148.          interface, but has many additional features and enhancements.
  149.          QFILER is written in Turbo Pascal and is extremely fast.  The
  150.          program makes full use of the PC keyboard, using the function
  151.          keys,  the  cursor  keys,  tab  key,  space  bar, and several
  152.          Control/Alt-key combinations.  In order  to make full use  of
  153.          all of QFILER's features, the following conditions should  be
  154.          met.
  155.  
  156.               The program is  designed to operate  satisfactorily with
  157.               DOS 2.x and above.  DOS  3.x is the operating system  of
  158.               choice, however.  In some cases, the extensions  offered
  159.               by   QFILER   depend   on   the   presence   of  DOS 3.x
  160.               enhancements.
  161.  
  162.          QFILER USERS' MANUAL                                  Page  3
  163.  
  164.  
  165.  
  166.               QFILER  requires  a  minimum  of  192K  memory  and  one
  167.               diskette drive for operation on an IBM-PC or  compatible
  168.               computer.  Additional  memory is  required to  use shell
  169.               options.
  170.  
  171.               The monitor may be either a color or a monochrome  unit,
  172.               with a command  line option supplied  for use with  mono
  173.               monitors attached to color video cards.
  174.  
  175.               Printers to be used with QFILER's setup options <Ctrl-P>
  176.               should be EPSON-command compatible.
  177.  
  178.  
  179.  
  180.                                   SETTING UP
  181.  
  182.          In preparation for using QFILER, if DOS 3.x is in use, invoke
  183.          PRINT.COM from either  the autoexec or  from the DOS  prompt.
  184.          QFILER.COM is  started by  typing QFILER  at the  DOS prompt.
  185.          For  ease  of  invoking,  it  may  be  advisable  to   rename
  186.          QFILER.COM to QF.COM, but that is up to the user.  There  are
  187.          three command line switch options that can be used at program
  188.          startup.   These  include:  [M]onochrome, [S]ort-on-name, and
  189.          [V]ideo-reverse-marks.  A disk\directory for the left or  for
  190.          both  windows  to  be  displayed  may  also be entered in the
  191.          command line, if desired.  Any or all of these options may be
  192.          utilized by entering:
  193.  
  194.  
  195.          QF[iler] [LeftDirectoryPath] [RightDirectoryPath] [/[[[M]V]S]
  196.  
  197.          at the DOS  prompt.  The square  brackets are used  to denote
  198.          the  options,  and  are  not  typed.   A "/" must preceed the
  199.          command  line  switches  which  may  be entered in any order.
  200.          Spaces are not required between switches.
  201.  
  202.          The Disk\Directory to be read  and displayed for the left  or
  203.          for both  windows may  be included  as a  command line option
  204.          when invoking QFiler.  Otherwise, the default drive and  path
  205.          directory will display in the left window.  The syntax  rules
  206.          are  the  same  as  discussed  under QUICK-START on page two.
  207.          This will save keystrokes when, for example, it is desired to
  208.          view the  "A:" drive,  when presently  logged in  to the "C:"
  209.          drive.
  210.  
  211.          The M  switch turns  off color,  and may  be used  whenever a
  212.          monochrome monitor attached  to a color  video card is  used,
  213.          for ease of screen reading.
  214.  
  215.          The S  switch turns  on the  "Sort by  File Name" option, and
  216.          should  be  used  if  sorted  directories are desired in both
  217.          windows, at  all times.   When this  switch is  not used, the
  218.          display will be unsorted, showing the real order of the files
  219.          on the  chosen drive  or directory,  and the  display will be
  220.          slightly faster, depending on the number of files the user is
  221.          working with.
  222.  
  223.          QFILER USERS' MANUAL                                  Page  4
  224.  
  225.  
  226.  
  227.          The  V  switch,  which  may  also  be called by <Alt><V> from
  228.          within QFILER,  will cause  marked files  to be  displayed in
  229.          reverse-video.  This  is useful  on composite  monitors which
  230.          may  not  adequately  display  high-intensity,  which is  the
  231.          default display for marked files.
  232.  
  233.          The following is a facsimile  of QFILER on a monitor  screen.
  234.          Some  of  the  on-screen  refinements  are,  of  course,  not
  235.          possible when printers are concerned,  so it will look a  bit
  236.          different in actual  use, and will  contain more lines.   Use
  237.          this illustration for reference in the User's Manual.
  238.  
  239.  
  240. |--------------------------------------||--------------------------------------|
  241. |               JAMESTOWN              ||                                      |
  242. |--------------------------------------||--------------------------------------|
  243. |                C:\DOS                ||     Quick-Filer 2.3 by Kenn Flee     |
  244. |--------------------------------------||--------------------------------------|
  245. | >.            <DIR>   071186 15:41   ||                                      |
  246. |  ..           <DIR>   071186 15:41   ||                                      |
  247. |  ASSIGN   COM    1509 030785 13:43   ||        USER SUPPORTED SOFTWARE       |
  248. |  BACKUP   COM    5577 030785 13:43   ||                                      |
  249. |  BASICA   COM   27520 030785 13:43   ||     If you are using this program    |
  250. |  CHKDSK   COM    9435 030785 13:43   ||      and find it to be of value,     |
  251. |  DEBUG    COM   15552 030785 13:43   ||       your contribution of $20       |
  252. |  DISKCOMP COM    4073 030785 13:43   ||         will be appreciated.         |
  253. |  DISKCOPY COM    4329 030785 13:43   ||                                      |
  254. |  ED       COM    7261 122185 23:08   ||          Jamestown Software          |
  255. |  EXE2BIN  EXE    2816 030785 13:43   ||         2508 Valley Forge Dr.        |
  256. |  FASTFMT  HLP    1195 031486  9:43   ||          Madison, WI  53719          |
  257. |  FFLABELS HLP     128 020386  0:17   ||                                      |
  258. |  FFMT     EXE   12800 031486  9:28   ||       Please copy this program       |
  259. |  FILECOMP COM    3664 030785 13:43   ||       and share it with others.      |
  260. |  FIND     EXE    6403 030785 13:43   ||                                      |
  261. |  FORM##   COM    9398 102985 17:14   ||    Press <H> for help or spacebar,   |
  262. |  GRAPHICS COM    3111 030785 13:43   ||   tab or first character to select   |
  263. |  IBMUTIL  LIB    6144 071884 12:01   ||                                      |
  264. |  LABEL    COM    1826 030785 13:43   ||                                      |
  265. |--------------------------------------||--------------------------------------|
  266. |dir:  385K   mrk:    0K   left:  2136K|| Copyright (C) 1986 Jamestown Software|
  267. |--------------------------------------||--------------------------------------|
  268.                             Clear all marked files.
  269. --------------------------------------------------------------------------------
  270.  UnMarkAll  Copy  Delete  MarkAll  Rename  Execute  List  VolLabel  Quit  Help
  271. --------------------------------------------------------------------------------
  272.  
  273.               Figure 1 - Facsimile of QFILER on a monitor screen.
  274.  
  275.          QFILER USERS' MANUAL                                  Page  5
  276.  
  277.  
  278.                              GEOGRAPHY OF QFILER
  279.  
  280.          The QFILER screen, as seen in Figure 1, is divided into three
  281.          sections with dual side-by-side upper windows for the display
  282.          of  file  information,  and  a  two-row  bottom  section  for
  283.          messages  and  menu.   Each  top  window row shows the Volume
  284.          Label for the respective  displayed disk.  The second  window
  285.          row, in reverse-video, will display the full DOS path for the
  286.          directory displayed in the window.  The large central  window
  287.          area  is  the  main  file  display  area, in which a full DOS
  288.          directory (DIR) format is shown.  The directory  additionally
  289.          displays hidden files  and, when applicable,  file attributes
  290.          Read-only, Hidden, and System.   Only one of the  two windows
  291.          may be considered "current" for menu or function key actions.
  292.          Currency is  shown by  a blinking  arrow pointer  in the left
  293.          margin area of the display area.  The pointer also  indicates
  294.          the "current  file" within  the "current  window".  Below the
  295.          main display, another reverse-video row, shows the  directory
  296.          size, total bytes marked, and remaining bytes of disk  space.
  297.          The  bottom  section  contains,  as  its top row, the message
  298.          line.  Here QFILER tells the user what is happening, or  what
  299.          the current menu selection description is.  Finally, the last
  300.          row is the  Menu Bar, with the current  selection highlighted
  301.          and the rest in reverse video.
  302.  
  303.  
  304.                                   NAVIGATION
  305.  
  306.          QFILER utilizes most of the keyboard in its operation.  There
  307.          are three logical areas of keyboard control:
  308.  
  309.               1.   Cursor pad selector/pointer movement.
  310.               2.   Function key program control.
  311.               3.   Typewriter keyboard command control.
  312.  
  313.          The cursor-key pad controls the combination file-selector and
  314.          window-selector.  The keys used on the cursor pad, and
  315.          their functions are:
  316.  
  317.                    1.  Right-Arrow  - Select Right Window.
  318.                    2.  Left-Arrow   - Select Left Window.
  319.                    3.  Up-Arrow     - Scroll selector pointer up or
  320.                                       window down a line.
  321.                    4.  Down-Arrow   - Scroll selector pointer down or
  322.                                       window up a line.
  323.                    5.  Home         - Selector to top of Window.
  324.                    6.  End          - Selector to bottom of Window.
  325.                    7.  Page-Up      - Scroll window up one page.
  326.                    8.  Page-Dn      - Scroll window down one page.
  327.  
  328.               Control-cursor-key combinations.
  329.  
  330.                    1.  Ctrl-Home  - Scroll window to top of disk/dir.
  331.                    2.  Ctrl-End   - Scroll window to end of disk/dir.
  332.  
  333.          QFILER USERS' MANUAL                                  Page  6
  334.  
  335.  
  336.          The function  keys control  all the  display options.   These
  337.          include sort order  and drive or  subdirectory  viewed.   The
  338.          function  keys  also  allow  modification  of  file attribute
  339.          bytes and  creation/deletion  of subdirectories.   To  use  a
  340.          function key, point (with arrow keys) at  a file to  use,  or
  341.          mark all  files  to  use  (see F9, F10 or the MarkAll command
  342.          below), and  press the  key.  The  function keys  are used as
  343.          follows:
  344.  
  345.               Normal Function-Key assignments.
  346.  
  347.                    F1  - Create a new subdirectory (DOS MKDIR/MD).
  348.                          User is prompted for name at command line
  349.                          at the bottom of the display.
  350.                    F2  - Remove selected subdirectory. (DOS RMDIR/RD)
  351.                    F3  - Display selected subdirectory in left window.
  352.                    F4  - Display selected subdirectory in right window.
  353.                    F5  - Prompt for a new path in left window.
  354.                    F6  - Prompt for a new path in right window.
  355.                    F7  - Sort the current window by name.
  356.                          (Same as command-line option [S].)
  357.                    F8  - Sort the current window by extension.
  358.                    F9  - Mark or unmark current file for group action.
  359.                    F10 - Same as F9, but advance to next file.
  360.  
  361.               Shifted Function-Key assignments.
  362.  
  363.                    F3  - Hide current file, directory, or marked files.
  364.                    F4  - Unhide current file, directory or marked files.
  365.                    F5  - Protect current or marked file(s).
  366.                          (Make them "Read-Only").
  367.                    F6  - Unprotect current or marked file(s).
  368.                    F7  - Sort current window by file size, ascending.
  369.                    F8  - Sort  current window by file date, then time,
  370.                          ascending.
  371.                    F9  - Set time and date  stamp on current or marked
  372.                          file(s).  System parameters may be  accepted.
  373.                          Date is entered as: 9/14/86.  Time is entered
  374.                          as:  8:5:0  or  11:56:23.   Zero-padding  the
  375.                          entry is unnecessary.  Enter as 24-hour clock.
  376.  
  377.          Menu-Bar selections control  QFILER actions, and  are invoked
  378.          by either moving the highlight to the desired command via the
  379.          spacebar or tab-key, and  pressing [Enter], or by  keying the
  380.          first letter of  the command name.   The spacebar or  tab-key
  381.          moves  the  highlight  to  the  right  and  the tab-key, when
  382.          shifted,   moves the highlight to the left.   Of the  various
  383.          options, mnemonic control is the  fastest method of control.
  384.  
  385.          QFILER USERS' MANUAL                                  Page  7
  386.  
  387.  
  388.                                 MENU COMMANDS
  389.  
  390.          The commands are as follows:
  391.  
  392.          UnmarkAll.. Will  turn  off  any  file  highlighting  within
  393.                      current window.
  394.  
  395.          Copy....... Will cause DOS copy to be executed on current  or
  396.                      marked files.
  397.  
  398.          Delete..... Will cause DOS  delete to be executed  on current
  399.                      or marked files.
  400.  
  401.          MarkAll.... Will  turn  on  file  highlighting  for all files
  402.                      within current window, so that all files will  be
  403.                      subject  to  action.     Selected  files  may  be
  404.                      unmarked with either the F9 or F10 keys.
  405.  
  406.          Rename..... Will cause DOS  rename to be executed  on current
  407.                      or marked files.   New name will be prompted for.
  408.  
  409.                      Files may  be MOVED  (rather than  copied) across
  410.                      subdirectory   boundaries   if   the    following
  411.                      conditions are met:
  412.  
  413.                      1.  DOS 3.x is in use.
  414.                      2.  Two directories of the same disk drive are
  415.                          displayed in the two windows.
  416.                      3.  One or more files are MARKED.
  417.                      4.  RENAME is selected and yes is answered to the
  418.                          question displayed.
  419.  
  420.                      The advantages of moving files are that the  move
  421.                      is  performed  faster  than  copy and that moving
  422.                      files does  not  degrade  hard  disk  performance
  423.                      through  disk  fragmentation  caused  by   reorg-
  424.                      anization.   Note that MOVE is the equivalent  of
  425.                      copying from one subdirectory   to  another, then
  426.                      deleting the files from the original directory...
  427.                      except  the files are not physically moved,  just
  428.                      their disk location identifier.
  429.  
  430.                      In addition (if using DOS 3.x) subdirectories may
  431.                      may  be  renamed  themselves  by  making them the
  432.                      current  file,  then  selecting  RENAME.    After
  433.                      renaming a  subdirectory, that  subdirectory will
  434.                      be displayed in the alternate window.
  435.  
  436.          Execute.... The  current file,  if an  executable type, i.e.,
  437.                      with extension BAT, COM, or EXE, will be run with
  438.                      a command line furnished for parameter entry.
  439.  
  440.                      There are two additional methods included (Ctrl-E
  441.                      & Ctrl-S) that  will allow  other programs  to be
  442.                      run from within QFILER.  These are covered in the
  443.                      CONTROL-KEY area of this document.
  444.  
  445.          QFILER USERS' MANUAL                                  Page  8
  446.  
  447.  
  448.          List....... For file display, the  user is given a  choice of
  449.                      <S>creen,  <E>dit,  <P>rint,  <C>ancel  all print
  450.                      jobs,  <L>itlbook,  <F>indit,  or  <ESC> to quit.
  451.                      The  brackets  signify  the  letter  or key to be
  452.                      pressed to  call the  option indicated.  <S> will
  453.                      invoke  the  browse  program  LIST.COM  for   the
  454.                      current file.  LIST will allow full screen  ASCII
  455.                      or HEX browse, and must be in the QFILER or other
  456.                      pathed directory. <E>  will invoke a  batch file,
  457.                      called  QFED.BAT,  created  by  the  user  in his
  458.                      QFILER directory, and pass to it the current file
  459.                      path, name,  and extension.   QFED.BAT needs  one
  460.                      line  consisting  of  the  path  and  name of the
  461.                      user's editor, and a replaceable parameter.   For
  462.                      example, if the editor  was KEDIT, stored in  the
  463.                      \PROG directory, the batch file would consist  of
  464.                      the line:
  465.  
  466.                                      \PROG\KEDIT %1
  467.  
  468.                      If DOS 3.x is  in use and PRINT.COM  is installed
  469.                      before running Quick Filer, <P> will add files to
  470.                      the print queue without exiting the program.   If
  471.                      desired,  all  jobs  in  the  print  queue may be
  472.                      cancelled by pressing <C>.  (Equivalent to the /T
  473.                      terminate  command).   <L>  will   call  (through
  474.                      LB.BAT) LITLBOOK.COM,  an address  book database.
  475.                      You may enter a search string to locate the entry
  476.                      to  be  displayed.   The  LB.BAT  file you create
  477.                      should  change  to  the  LITLBOOK directory, then
  478.                      call LITLBOOK with a replaceable parameter:
  479.  
  480.                                      CD \LITLEBOOK
  481.                                      LITLBOOK %1
  482.  
  483.                      <F> will  link to  the FINDIT.COM  program, which
  484.                      which will search the specified or default  drive
  485.                      for  all  occurrences  of  the  file  search mask
  486.                      passed to  it from  the user  input requested  by
  487.                      this option at bottom of the screen.  The results
  488.                      of  the  search  will  display  on  the following
  489.                      screen.  Pressing  the enter  key with  no search
  490.                      mask will cause FINDIT  to display a full  screen
  491.                      of help information.  Searches resulting in  more
  492.                      than  one  screen  may  be  piped through the DOS
  493.                      external command, MORE.COM, to pause each screen.
  494.                      Please  read  the  documentation  for  FINDIT for
  495.                      complete understanding of the program.
  496.  
  497.          VolLabel... The  current window  disk may  be given  a volume
  498.                      label with this option. The user is prompted  for
  499.                      the label.
  500.  
  501.          Quit....... Exits program and returns to DOS.
  502.  
  503.          Help....... Full screen of help notes for user reminder.
  504.  
  505.          QFILER USERS' MANUAL                                  Page  9
  506.  
  507.  
  508.          After a menu selection is made, either by spacebar/tab-key or
  509.          mnemonic choice, QFILER  will check to  see if any  files are
  510.          marked.  (These are files highlighted by the F9/F10 key.)  If
  511.          it finds marked files, it will ask whether the user wants  to
  512.          act upon the marked files or the current file only.  The user
  513.          will see a prompt on the message line and a small two  choice
  514.          menu  replacing  the  main  one,  which  indicates  the   two
  515.          available choices.  A  spacebar or mnemonic  choice is to  be
  516.          made here.  If no files are marked, the user is prompted  for
  517.          appropriate path  or name  entry.  Then  QFILER will  ask for
  518.          verification of  the pending  action.  A  "y" response causes
  519.          execution of the command, and an "n" aborts the operation and
  520.          returns  to  the  normal  display  with any highlighted files
  521.          still highlighted.
  522.  
  523.                        CONTROL/ALTERNATE-KEY COMBINATIONS
  524.  
  525.          <Ctrl><A> From the main  display, will bring  up a menu  line
  526.                    showing  the  following  options:  <A>dd  <E>xtract
  527.                    <V>erbose Listing  <ESC> Quit.  These options  call
  528.                    Vernon  Buerg's  ARCA,  ARCE,  and  ARCV  programs,
  529.                    respectively, which must be in the QFILER or  other
  530.                    pathed directory.  These  options allow use  of the
  531.                    ARChive  file  format,   made  popular  by   System
  532.                    Enhancement Assoc., 21 New St., Wayne, NJ 07470.
  533.  
  534.                    ARCA (create or add to  an ARC file) -- First  mark
  535.                    all the files to be included in the ARC file.  Then
  536.                    press Ctrl-A, then "A".  QFILER will prompt for the
  537.                    ARC file name.  A path  may be included if the  ARC
  538.                    file is not to be created in the current directory.
  539.                    Use  QFILER  sort   options,  if  desired,   before
  540.                    creating the ARChive.  ARCA NOTE: Although the ARCA
  541.                    DOC's mention that ARCA is not intended to be  used
  542.                    precisely in the manner QFILER links to it, it does
  543.                    work... if there is no  .ARC of the same .ARC  name
  544.                    as the one  you are creating.   Please check to  be
  545.                    certain you  are not  inadvertently "adding"  to an
  546.                    existing .ARC file that may already include one  of
  547.                    the files you are  "adding" to it.  The  ARCA doc's
  548.                    further  mention  that   if  there  is   sufficient
  549.                    "clamor" to modify ARCA  to include the ability  to
  550.                    update  included  files  to  contact  Vern Buerg at
  551.                    the BBS number listed in his docs.  Until or unless
  552.                    ARCA specifically  includes the  ability to  update
  553.                    included files, simply be  aware of the need  to be
  554.                    certain you are actually creating a new .ARC  file.
  555.                    The QFILER approach does work: All QFILER.ARC files
  556.                    were created by QFILER itself, linking to ARCA.
  557.  
  558.  
  559.          QFILER USERS' MANUAL                                 PAGE  10
  560.  
  561.  
  562.                    ARCE (extract or expand  an .ARC file) --  Make the
  563.                    desired  ARC  file  the  current  file,  then press
  564.                    Ctrl-A followed  by "E".   The command  line as  it
  565.                    will be passed to Command.Com will be displayed  at
  566.                    the bottom of the screen.  To extract all files  in
  567.                    the ARC file to  the current directory, just  press
  568.                    the  return  key.   If  only  one  file  is  to  be
  569.                    extracted, or  files are  to be  extracted to  some
  570.                    other disk or directory, first press the <END>  key
  571.                    to move the cursor to end of the command line, then
  572.                    enter the path and/or filespec to pass to ARCE.
  573.  
  574.                    ARCV (Verbose listing of ARC file contents) -- Make
  575.                    the desired ARC file  the current file, then  press
  576.                    Ctrl-A followed by "V" for the listing of the ARC.
  577.  
  578.                    Please read  the documentation  for ARCA,  ARCE and
  579.                    ARCV for an explanation of command line options.
  580.  
  581.          <Ctrl><B> Will  initiate  the  QFILER  BACKUP  utility.   Any
  582.                    marked files in the "source" directory window  will
  583.                    be  compared  to  files  in  the "target" directory
  584.                    window.  Files will be copied, only if they do  not
  585.                    exist on the target,  or if the date/time  stamp on
  586.                    the source files are newer than those on the target
  587.                    files.  File remain marked for optional deletion.
  588.  
  589.          <Ctrl><E> Will allow entering a program name as if at the DOS
  590.                    prompt.   For  convenience,  <F10>  will return the
  591.                    current path\filename.  QFILER will then change  to
  592.                    the  ENTRY  drive\directory  and  pass the  command
  593.                    line to COMMAND.COM.  Upon completion of the passed
  594.                    program, press any key to return to QFILER.
  595.  
  596.                    EXAMPLE:   Suppose it is necessary to run DISMOD on
  597.                               the current file. First press <Ctrl><E>.
  598.                               Then  type DISMOD.  Then press  <F10> to
  599.                               input the current file. Press Enter.
  600.  
  601.          <Ctrl><F> Provides  an automatic  link with  FILECAT (through
  602.                    FCDISK) that creates a  text file on a  target disk
  603.                    that  lists  files  on  the  disk (in alpha order),
  604.                    filesize, and description of the file (if the  file
  605.                    is included in the FILECAT database).  To use  this
  606.                    feature  both  FCDISK  and  FILECAT  must be in the
  607.                    QFILER  or  a  pathed  directory.   To  use, do the
  608.                    following:
  609.  
  610.                    a. Be  certain  that  FCDISK  is  either  with  the
  611.                       FILECAT data files, or pathed.
  612.  
  613.                    b. Bring up  the target disk/dir  (the one where  a
  614.                       text file to be written) on one side of QF.
  615.  
  616.          QFILER USERS' MANUAL                                 PAGE  11
  617.  
  618.  
  619.  
  620.                    c. Bring up the  FILECAT data file disk/dir  on the
  621.                       alternate side.
  622.  
  623.                    d. Be certain the  flashing cursor and pointer  are
  624.                       on the FILECAT side of the QFILER display.
  625.  
  626.                    e. Press <Ctrl><F>.  QFILER will automatically load
  627.                       FCDISK.
  628.  
  629.                    f. Answer the questions  that are asked.  The  text
  630.                       file will be created on the target disk and  the
  631.                       user will be returned to QFILER.
  632.  
  633.                    NOTE: The following steps are optional:
  634.  
  635.                    g. Make the target disk side the current window.
  636.  
  637.                    h. Press <Ctrl><R> to refresh the side and  display
  638.                       the new file.
  639.  
  640.                    i. Point to the new  file, then press "L" then  "S"
  641.                       to list to the screen and view what was created.
  642.  
  643.          <Ctrl><P> From the main display, will bring up a menu line to
  644.                    set  or  cancel   skip-over-perf  and  to   send  a
  645.                    form-feed, for Epson-compatible printers.
  646.  
  647.          <Alt><R>  Will refresh  the entire screen display  of QFILER.
  648.                    This will  straighten out  a screen  that may  have
  649.                    been messed up by  stray DOS hardware messages  and
  650.                    the like.
  651.  
  652.          <Ctrl><R> Will  refresh the  display of  the current  window.
  653.                    This is handy if the user has "shelled" to DOS  and
  654.                    has changed  the displayed  directory by  adding or
  655.                    deleting a file.  The refresh will display the new,
  656.                    changed directory.  (Use after ARC operations!)
  657.  
  658.          <Ctrl><S> Is  for  those  instances  where   the   previously
  659.                    explained <Ctrl><E> procedure won't work  (commands
  660.                    within  COMMAND.COM  itself,  like  DIR).  Pressing
  661.                    Control-S will load a secondary copy of COMMAND.COM
  662.                    and return to the DOS prompt.  (The user will be in
  663.                    the  CURRENT  drive\directory).   When  ready, type
  664.                    EXIT to return to QFILER.
  665.  
  666.          <Alt><V>  Will toggle  between hi-intensity white and reverse
  667.                    video  display  for  marked  files.   (Useful   for
  668.                    monitors that don't display hi-intensity or  bright
  669.                    colors).
  670.  
  671.                    The command line option  [V]  may  be  included  to
  672.                    invoke QF with the inverse video option ON.
  673.  
  674.          QFILER USERS' MANUAL                                 PAGE  12
  675.  
  676.  
  677.                                 ERROR MESSAGES
  678.  
  679.                        001 File does not exist
  680.                        002 File is not open for input
  681.                        003 File is not open for output
  682.                        004 File is not open
  683.                        005 Read error or directory not found
  684.                        006 Write error
  685.                        016 Invalid numeric format
  686.                        032 Not allowed on logical device
  687.                        033 Not allowed in direct mode
  688.                        034 Cannot assign to standard files
  689.                        144 Record length mismatch
  690.                        145 Cannot seek beyond end of file
  691.                        153 Unexpected end of file
  692.                        240 Disk write error occurred
  693.                        241 Directory is full
  694.                        242 File size overflow
  695.                        255 File disappeared
  696.  
  697.          By  displaying  these  error  numbers, QFILER  overrides  the
  698.          frustrating DOS "Abort, Retry, Ignore" message.  If any other
  699.          numbers are displayed, please report them to us.
  700.  
  701.  
  702.          QFILER USERS' MANUAL                                 PAGE  13
  703.  
  704.  
  705.  
  706.                                 MISCELLANEOUS
  707.  
  708.          QFILER has as many user safeguards built in as possible, with
  709.          as  many  user  escape  opportunities  as  is prudent.  Overt
  710.          hand-holding has been avoided,  however.  This  program, used
  711.          carefully, will  be of  immense value  to the  user.  If used
  712.          carelessly however, it can be dangerous.  Please be  careful.
  713.          READ the messages and prompts as they are presented.
  714.  
  715.          QFILER  documentation  is  written,  keyed, and formatted for
  716.          Jamestown Software by QFILER Beta-Tester:
  717.  
  718.                                James L. Wargula
  719.                               760  Pilgrim Trail
  720.                             Sun Prairie, WI. 53590
  721.  
  722.          If additional features are wished to be included in QFILER or
  723.          you  discover any  program errors  (write  down  any  numbers
  724.          displayed on the screen), please contact:
  725.  
  726.                                   Kenn Flee
  727.                               Jamestown Software
  728.                            2508 Valley Forge Drive
  729.                               Madison WI  53719
  730.  
  731.                             Compuserve # 74275,745
  732.  
  733.                                BBS: 608-251-7734
  734.                     (24 Hr., 300-1200-2400, 8-N-1, no nulls)
  735.  
  736.  
  737.  
  738.  
  739.  
  740.                             USER SUPPORTED SOFTWARE
  741.  
  742.          This  program is distributed for personal,  private  use  and
  743.          with  the understanding that if it is used and found to be of
  744.          value,   the  user will register with a contribution of  $20.
  745.          This   action  will  be   appreciated  and  will    encourage
  746.          further  development.     Upon  receipt   of registration,  a
  747.          disk  with  the  most recent  version  of   QFILER,   support
  748.          programs,   plus  a  printed  manual,  and   a  function  key
  749.          template will be mailed to the user.
  750.  
  751.          Commercial use without registration and license is prohibited.
  752.  
  753.          In any case, copy the program and share it with others.
  754.  
  755.          For the convenience of corporate users and others,  a printed
  756.          invoice is included on the next page.
  757.  
  758.  
  759.  
  760.  
  761.                           --------------------------
  762.                                    INVOICE
  763.                           --------------------------
  764.  
  765.  
  766.  
  767.                               JAMESTOWN SOFTWARE
  768.                            2508 Valley Forge Drive
  769.                               Madison WI  53719
  770.  
  771.  
  772.          Sold to: ___________________________________________________
  773.  
  774.                   ___________________________________________________
  775.  
  776.                   ___________________________________________________
  777.  
  778.  
  779.          Date:    ______________________________
  780.  
  781.  
  782.          ============================================================
  783.  
  784.  
  785.  
  786.  
  787.          _____ copies of QFILER at $20 each ............$____________
  788.  
  789.                Wisconsin residents add 5% Sales Tax .... ____________
  790.  
  791.  
  792.                                    TOTAL ENCLOSED.......$____________
  793.  
  794.  
  795.  
  796.  
  797.                       Send this invoice and your check to:
  798.  
  799.                                Jamestown Software
  800.                             2508 Valley Forge Drive
  801.                                 Madison WI 53719
  802.  
  803.  
  804.  
  805.          ============================================================
  806.  
  807.  
  808.          Thank you for your support................Jamestown Software
  809.  
  810.          Registered  owners  will be sent a disk containing  the  most
  811.          recent version of QFILER,  support programs, a printed manual
  812.          and   function  key  template.   Registered  owners  will  be
  813.          notified of any major upgrades and/or future enhancements.
  814.  
  815.          For  a  large number of QFILER packages,   contact  Jamestown
  816.          Software for site licensing or quantity pricing.
  817.  
  818.  
  819.